Skip to content

feat(agent): include semantic model in feasibility assessment - #622

Open
pwd11 wants to merge 2 commits into
spring-ai-alibaba:mainfrom
pwd11:fix/266-feasibility-semantic-model
Open

pwd11 wants to merge 2 commits into
spring-ai-alibaba:mainfrom
pwd11:fix/266-feasibility-semantic-model

Conversation

@pwd11

@pwd11 pwd11 commented Sep 6, 2026 •

Copy link
Copy Markdown

Describe what this PR does / why we need it

FeasibilityAssessmentNode 的提示词目前只包含规范化查询、召回 Schema、Evidence 和多轮历史,缺少 TableRelationNode 已经计算好的语义模型(GENEGRATED_SEMANTIC_MODEL_PROMPT)。当用户使用业务术语/同义词表达指标口径时,可行性评估节点缺少映射依据,容易误判为 NEED_CLARIFICATION 或漏掉 Schema 可支持的查询。

本次修改把语义模型渲染进 feasibility-assessment 模板,处理方式与 PlannerNode 保持一致。

Does this pull request fix one issue?

Fixes #266

Describe how you did it

实现文档(背景、数据流、实现细节、前后示例与验证边界):#266 (comment)

  • prompts/feasibility-assessment.txt:指令边界与判定顺序补充语义模型使用规则;输入数据区新增「## 语义模型」小节
  • PromptHelper.buildFeasibilityAssessmentPrompt(...):新增 semanticModel 参数并渲染 {semantic_model}
  • FeasibilityAssessmentNode.apply(...):从 state 读取 GENEGRATED_SEMANTIC_MODEL_PROMPT(TableRelationNode 已写入)传入模板
  • 测试:PromptHelperTest 更新参数与断言;FeasibilityAssessmentNodeTest 注册新 state key 并新增 apply_withSemanticModel_includesModelInPrompt 用例

Describe how to verify it

  • ./mvnw -pl data-agent-management -Dtest=PromptHelperTest,FeasibilityAssessmentNodeTest test — 38 个用例全部通过
  • ./mvnw -pl data-agent-management spotless:check checkstyle:check — 0 violations

Special notes for reviews

…-ai-alibaba#266)

FeasibilityAssessmentNode 的提示词缺少 TableRelationNode 已计算好的语义模型,
导致使用业务术语/同义词表达指标口径时可行性评估缺少映射依据。

- feasibility-assessment.txt: 指令边界与判定顺序补充语义模型使用规则,新增「## 语义模型」输入小节
- PromptHelper.buildFeasibilityAssessmentPrompt: 新增 semanticModel 参数
- FeasibilityAssessmentNode: 从 state 读取 GENEGRATED_SEMANTIC_MODEL_PROMPT 传入模板
- 测试: PromptHelperTest 与 FeasibilityAssessmentNodeTest 同步更新,新增语义模型注入用例
PromptConstantTest 的全量渲染校验要求模板变量全部声明;feasibility-assessment
模板新增 {semantic_model} 后补充契约变量,避免全量测试失败。
@pwd11

pwd11 commented Oct 6, 2026

Copy link
Copy Markdown
Author

@zxuexingzhijie 按要求整理的实现文档已于 9 月 26 日发布到 #266,PR 正文也已补充入口。

文档覆盖数据流、具体改动、Schema 使用边界、空值兼容、前后输入示例和验证依据,并区分了 mock 测试能够证明的参数传递与尚未实测的真实模型效果。对应当前提交 2b503db。方便时烦请审阅,若实现方案或文档需要调整,我会继续补充。谢谢。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature] 可行性评估节点忘记加入语义模型知识

1 participant